PATH Mac OS 8 and 9 Developer Documentation > Text and Other International Services > Apple Type Services for Unicode Imaging (ATSUI) > Apple Type Services for Unicode Imaging Reference
     

ATSUCountFontNames

Counts the number of font names in a font.

OSStatus ATSUCountFontNames( 
                     ATSUFontID iFontID,
                     ItemCount *oFontNameCount);
iFont
A value of type ATSUFontID. Pass the ID of the font whose names you want to count.

oFontNameCount
A pointer to a count. On return, the total number of entries in the font name table. This count includes the names of font features, variations, tracking settings, and instances, as well as font names identified by name code constants that aren't enumerated. You cannot pass a NULL pointer for this parameter.

function result
A result code. The result code kATSUInvalidFontErr indicates that the ID does not correspond to an installed font. For a list of other ATSUI-specific result codes, see Result Codes.
DISCUSSION
The ATSUCountFontNames function obtains the total number of font names defined in a font name table. This includes repetitions of the same name in different platforms, languages, and scripts, as well as other strings such as the names of font features, variations, tracking settings, and instances. You can pass one less than this count in the iFontNameIndex parameter of the function ATSUGetIndFontName to iterate through the entries of a font name table.

VERSION NOTES
Available beginning with ATSUI 1.0.
© 2000 Apple Computer, Inc. – (Last Updated 25 Jan 00)